This PMSAM routes mail between AOCE and Internet-based mail accounts. It uses the SMTP (Simple Mail Transfer Protocol) to send mail and the POP (Post Office Protocol version 3) to fetch mail. It is an on-demand gateway, meaning that it will download messages to the Mac immediately instead of waiting for the user to open them.
The PMSAM has been written as a background only application, and its associated address and setup Directory Extension Templates are included in the PMSAM file itself, so it has a one step installation process.
How to install
-------------
1) Drag the file "Internet PMSAM" to your Extensions Folder and reboot.
2) Next, open the "PowerTalk Keychain" icon and click on the "Add..." button. You'll get a dialog asking what service to add. Select the "Internet Mail Service" item and click OK.
3) A new icon, called Internet Service will appear in the Setup list. To open it, double click it or select it and click Open.
4) The configuration window for the PMSAM will now appear. You need to fill in your user name on the mail host and your password (click the password button and type it in) first.
5) For SMTP server and POP server, enter the IP hostnames that are used for sending mail and receiving mail respectively. Check with your system administrator if you aren't sure what to put here. For best results, you probably want to set these to the same host.
6) Enter the send interval and receive interval in minutes. This is how often the MSAM will contact the remote hosts to send outgoing mail and to receive incoming mail. Leaving these values at 1/1 is a bad idea except for debugging, since checking for mail may be a time consuming process. 15 minutes or half an hour should be sufficient. Also, and messages you send from your Mac will be sent out through SMTP immediately.
7) Close the window
8) reboot your Mac (optional)
How to change your setup information
----------------------------------
If you want to change your setup information (if your name or password changes, or you want to change send/receive times/etc...), you can do this through the same procedure as above.
1) Open the Key Chain icon.
2) Double-click the Internet Service icon.
3) edit your configuration information (note that your old password is required to change your password.
4) close the window. no need to reboot this time
How to use it
------------
Once configured, any mail residing on your Internet mail account will be fetched by the PMSAM and will appear in your inbox. You can send messages by replying to messages routed by the PMSAM, by using the type-in addressing feature in the Mailer, or by creating new addresses in the Personal Directory via the included built-in address template.
Updating to a newer version
-------------------------
To upgrade to a newer version of the PMSAM, do the following:
1) drag the old PMSAM from the extensions folder to the trash
2) drop the new version of the PMSAM in the Extensions folder
3) reboot
4) open the keychain icon
5) double-click the Internet service in the key chain window
6) close the PMSAM window
7) reboot
8) you should now be running with the new version without losing any mail
Other Info
----------
The PMSAM will only send and receive mail when the AOCE Master Key is unlocked. If you're writing your own PMSAM, you should normally continue routing mail even when the identity is locked if possible.
Only text is handled, and enclosures aren't sent, and text is submitted in TEXT blocks, with no font information. The letter application will format all of these blocks in Monaco 9.
If you continue to receive the same message or messages over and over, or if you get a "password is incorrect" report, you may have zombie pop server clients running on your UNIX box. To fix this, log into your UNIX account using Telnet, then type "ps -aux | grep pop", and look for POP server processes with your user name. If you find one or more, kill them using the UNIX kill command and try again. Also, if the MSAM gets caught on a message it can't process, it will try it over and over. You may have to delete such messages manually.
This has only been written as sample code for developers, not for high volume production use, explaining some of the features it doesn't support.
Product is packed by weight rather than volume. During shipping, contents may have settled, rendering product inedible.
Compilation Environment:
MPW
THINK C 6
Restrictions:
PowerTalk System 7 Pro 1.0
MacTCP 1.1.1 or later pre-configured (not included)
An account on a TCP/IP based mail host running POP and SMTP and a connection to
that host
Author: Steve Falkenburg-DTS, AppleLink: DEVSUPPORT
Questions/Comments: As with the other AOCE samples, technical questions should be addressed to DEVSUPPORT.
This tool is provided as part of the AOCE SDK. Use of this tool for any purpose other than the development of AOCE-based Macintosh® products is a violation of the license agreement covering this SDK.
